home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Complementary Applications 2004 February / SGI IRIX 6.5 Complementary Applications 2004 February.iso / dist / cde.idb / usr / dt / share / man / cat3 / MrmFetchWidgetOverride.z / MrmFetchWidgetOverride
Encoding:
Text File  |  2003-11-18  |  6.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeettttOOOOvvvveeeerrrrrrrriiiiddddeeee((((3333XXXX))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVVMMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeettttOOOOvvvveeeerrrrrrrriiiiddddeeee((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       _M_r_m_F_e_t_c_h_W_i_d_g_e_t_O_v_e_r_r_i_d_e - Fetches any indexed (UIL named)
  10.       application widget.  It overrides the    arguments specified
  11.       for this application widget in UIL
  12.  
  13.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.       #include <Mrm/MrmPublic.h>
  15.  
  16.       Cardinal MrmFetchWidgetOverride(hhhhiiiieeeerrrraaaarrrrcccchhhhyyyy____iiiidddd,,,,    iiiinnnnddddeeeexxxx,,,, ppppaaaarrrreeeennnntttt____wwwwiiiiddddggggeeeetttt,,,, oooovvvveeeerrrrrrrriiiiddddeeee____nnnnaaaammmmeeee,,,,
  17.             oooovvvveeeerrrrrrrriiiiddddeeee____aaaarrrrggggssss,,,, oooovvvveeeerrrrrrrriiiiddddeeee____nnnnuuuummmm____aaaarrrrggggssss,,,, wwwwiiiiddddggggeeeetttt,,,, ccccllllaaaassssssss)
  18.            _M_r_m_H_i_e_r_a_r_c_h_yhhhhiiiieeeerrrraaaarrrrcccchhhhyyyy____iiiidddd;
  19.            _S_t_r_i_n_g     iiiinnnnddddeeeexxxx;
  20.            _W_i_d_g_e_t     ppppaaaarrrreeeennnntttt____wwwwiiiiddddggggeeeetttt;
  21.            _S_t_r_i_n_g     oooovvvveeeerrrrrrrriiiiddddeeee____nnnnaaaammmmeeee;
  22.            _A_r_g_L_i_s_t     oooovvvveeeerrrrrrrriiiiddddeeee____aaaarrrrggggssss;
  23.            _C_a_r_d_i_n_a_l     oooovvvveeeerrrrrrrriiiiddddeeee____nnnnuuuummmm____aaaarrrrggggssss;
  24.            _W_i_d_g_e_t     *wwwwiiiiddddggggeeeetttt;
  25.            _M_r_m_T_y_p_e     *ccccllllaaaassssssss;
  26.  
  27.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  28.       The _M_r_m_F_e_t_c_h_W_i_d_g_e_t_O_v_e_r_r_i_d_e function is the extended version
  29.       of _M_r_m_F_e_t_c_h_W_i_d_g_e_t.  It is identical to _M_r_m_F_e_t_c_h_W_i_d_g_e_t,
  30.       except that it allows    the caller to override the widget's
  31.       name and any arguments that _M_r_m_F_e_t_c_h_W_i_d_g_e_t would otherwise
  32.       retrieve from    the UID    file or    one of the defaulting
  33.       mechanisms.  That is,    the override argument list is not
  34.       limited to those arguments in    the UID    file.
  35.  
  36.       The override arguments apply only to the widget fetched and
  37.       returned by this function.  Its children (subtree) do    not
  38.       receive any override parameters.
  39.  
  40.       hhhhiiiieeeerrrraaaarrrrcccchhhhyyyy____iiiidddd
  41.            Specifies the ID    of the UID hierarchy that contains the
  42.            interface definition.  The hhhhiiiieeeerrrraaaarrrrcccchhhhyyyy____iiiidddd was returned in
  43.            a previous call to _M_r_m_O_p_e_n_H_i_e_r_a_r_c_h_y_P_e_r_D_i_s_p_l_a_y.
  44.  
  45.       iiiinnnnddddeeeexxxx
  46.            Specifies the UIL name of the widget to fetch.
  47.  
  48.       ppppaaaarrrreeeennnntttt____wwwwiiiiddddggggeeeetttt
  49.            Specifies the parent widget ID.
  50.  
  51.       oooovvvveeeerrrrrrrriiiiddddeeee____nnnnaaaammmmeeee
  52.            Specifies the name to override the widget name.    Use a
  53.            NULL value if you do not    want to    override the widget
  54.            name.
  55.  
  56.       oooovvvveeeerrrrrrrriiiiddddeeee____aaaarrrrggggssss
  57.            Specifies the override argument list, exactly as    given
  58.            to _X_t_C_r_e_a_t_e_W_i_d_g_e_t (conversion complete and so forth).
  59.            Use a NULL value    if you do not want to override the
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 11/11/03)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeettttOOOOvvvveeeerrrrrrrriiiiddddeeee((((3333XXXX))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVVMMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeettttOOOOvvvveeeerrrrrrrriiiiddddeeee((((3333XXXX))))
  71.  
  72.  
  73.  
  74.            argument    list.
  75.  
  76.       oooovvvveeeerrrrrrrriiiiddddeeee____nnnnuuuummmm____aaaarrrrggggssss
  77.            Specifies the number of arguments in oooovvvveeeerrrrrrrriiiiddddeeee____aaaarrrrggggssss.
  78.  
  79.       wwwwiiiiddddggggeeeetttt
  80.            Returns the widget ID of    the created widget.
  81.  
  82.       ccccllllaaaassssssss
  83.            Returns the class code identifying MRM's    widget class.
  84.            Literals    identifying MRM    widget class codes are defined
  85.            in the include file <_M_r_m/_M_r_m_P_u_b_l_i_c._h>.
  86.  
  87.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  88.       This function    returns    one of these status return constants:
  89.  
  90.       _M_r_m_S_U_C_C_E_S_S
  91.            The function executed successfully.
  92.  
  93.       _M_r_m_B_A_D__H_I_E_R_A_R_C_H_Y
  94.            The hierarchy ID    was invalid.
  95.  
  96.       _M_r_m_N_O_T__F_O_U_N_D
  97.            The widget was not found    in UID hierarchy.
  98.  
  99.       _M_r_m_F_A_I_L_U_R_E
  100.            The function failed.
  101.  
  102.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  103.       _M_r_m_O_p_e_n_H_i_e_r_a_r_c_h_y_P_e_r_D_i_s_p_l_a_y(_3_X), _M_r_m_F_e_t_c_h_W_i_d_g_e_t(_3_X).
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 11/11/03)
  130.  
  131.  
  132.  
  133.